/**
 * Copyright (c) 2011 eelpo.com
 * All rights reserved.
 */
package com.eelpo.cmmp.basic.dao;

import java.util.List;

import com.eelpo.cmmp.basic.dao.entity.TSystemConfig;
import com.eelpo.cmmp.basic.dao.vo.SystemConfig;

import org.springframework.dao.DataAccessException;

/**
 * <pre>
 * 
 * 系统配置数据访问 接口定义
 * 
 * </pre>
 * 
 * @author <a href="mailto:Brian@eelpo.com">汪洪州</a>
 * @since 1.0
 */
public interface ISystemConfigManageDao {
	/**
	 * 根据系统配置Id获取系统配置对象
	 * 
	 * @param id
	 *            系统配置ID
	 * @return 返回系统配置值对象
	 * @throws DataAccessException
	 *             抛出数据访问异常
	 */
	public TSystemConfig getSystemConfigById(String id) throws DataAccessException;

	/**
	 * 根据系统配置Key获取系统配置对象
	 * 
	 * @param key
	 *            系统配置Key值
	 * @return 返回系统配置值对象
	 * @throws DataAccessException
	 *             抛出数据访问异常
	 */
	public TSystemConfig getSystemConfigByKey(String key) throws DataAccessException;

	/**
	 * 检查系统配置Key是否已经存在
	 * 
	 * @param key
	 *            系统配置Key值
	 * @return 返回布尔值，true表示已经存在，false表示不存在
	 * @throws DataAccessException
	 *             抛出数据访问异常
	 */
	public boolean checkExist(String key) throws DataAccessException;

	/**
	 * 检查系统配置Key是否已经存在，用于修改系统配置
	 * 
	 * @param id
	 *            系统配置Id
	 * @param key
	 *            系统配置Key值
	 * @return 返回布尔值，true表示已经存在，false表示不存在
	 * @throws DataAccessException
	 *             抛出数据访问异常
	 */
	public boolean checkExistByUpdate(String id, String key) throws DataAccessException;

	/**
	 * 新增系统配置
	 * 
	 * @param config
	 *            系统配置对象
	 * @return 返回新增过的系统配置Id
	 * @throws DataAccessException
	 *             抛出数据访问异常
	 */
	public String addSystemConfig(TSystemConfig config) throws DataAccessException;

	/**
	 * 修改系统配置
	 * 
	 * @param config
	 *            系统配置对象
	 * @throws DataAccessException
	 *             抛出数据访问异常
	 */
	public void updateSystemConfig(TSystemConfig config) throws DataAccessException;

	/**
	 * 根据Id删除系统配置
	 * 
	 * @param id
	 *            系统配置Id
	 * @throws DataAccessException
	 *             抛出数据访问异常
	 */
	public void deleteSystemConfig(String id) throws DataAccessException;

	/**
	 * 根据参数获取系统配置分页列表
	 * 
	 * @param config
	 *            系统配置参数
	 * @param first
	 *            分页起始条数
	 * @param max
	 *            分页获取的单页条数
	 * @return 返回系统配置分页列表
	 * @throws DataAccessException
	 *             抛出数据访问异常
	 */
	public List<TSystemConfig> getSystemConfigsPaing(SystemConfig config, final int first, final int max) throws DataAccessException;

	/**
	 * 根据参数获取系统配置数量
	 * 
	 * @param config
	 *            系统配置参数
	 * @return 返回系统配置数量
	 * @throws DataAccessException
	 *             抛出数据访问异常
	 */
	public int getSystemConfigsCount(SystemConfig config) throws DataAccessException;
}
